Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Enhancing Movie Playback Performance

SetMediaShadowSync

The SetMediaShadowSync function creates an association between the indicated frame difference sample and a specified self-contained sample in a given media. This association makes the self-contained sample a shadow sync sample for the frame difference sample.

pascal OSErr SetMediaShadowSync (Media theMedia, 
                                 long frameDiffSampleNum, 
                                 long syncSampleNum);

theMedia

The media in which the shadow sync is to be created.

frameDiffSampleNum

Specifies a frame difference sample. The sample number is obtained from the MediaTimeToSampleNum function.

syncSampleNum

Specifies a shadow sync sample. The sample number is obtained from the MediaTimeToSampleNum function.

DESCRIPTION

Note that the association established is between sample numbers--not sample times.

SPECIAL CONSIDERATIONS

Shadow sync samples should not be part of a track. You should not call InsertMediaIntoTrack on these media samples. Typically, you add shadow sync samples after a media is completely created. Shadow sync samples are not maintained when editing or flattening movies.

ERROR CODES

Memory Manager errors